home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / pcburm14.zip / PCBURM.DOC < prev    next >
Text File  |  1993-01-06  |  15KB  |  370 lines
  1.                                   PCBURM
  2.                                 -----------
  3.  
  4.                          PCBoard User Ratio Monitor
  5.  
  6.                    A PCBoard File/Byte Download Monitor
  7.  
  8.                                Version 1.4
  9.  
  10.                             For PCBoard v14.5a
  11.  
  12.  
  13.                                 - - - - -
  14.  
  15.  
  16.                        Copyright 1993 - Robert Neal
  17.                                 317 Hickory
  18.                            Romeoville, IL  60441
  19.  
  20.                                Support BBS:
  21.                        Corporate Headquarters BBS
  22.                  Node #1: (815) 886-3233  14400 v.32bis
  23.                  Node #2: (815) 886-9381  14400 v.32bis
  24.  
  25.  
  26.  
  27.  
  28. Changes to this documentation file from the previous version are
  29. indicated by "|" in the left hand margin. This should make finding
  30. changes to the documentation much easier and faster for those upgrading
  31. from previous versions.
  32.  
  33.  
  34.  
  35.                            PROGRAM INFORMATION
  36.                            ===================
  37.  
  38. PCBoard User Ratio Monitor (PCBURM) is a utility door written for PCBoard
  39. v14.5a. PCBURM will enforce your desired ratios with each call the user makes
  40. to your board. PCBURM was written because PCBoard lacks a ratio enforcement
  41. method that is easy to use and understand, and one that can be run "real
  42. time". In looking around for similar products, everyone I've seen seem to be
  43. overkill, didn't effectively handle particular user requirements or just plain
  44. didn't seem to work.
  45.  
  46. In creating PCBURM, it was designed to be just one thing, a file/byte
  47. monitoring and enforcement tool for PCBoard. PCBURM will check for either a
  48. file ratio, byte ratio or both, sysop defined. There is no "banking" features,
  49. message ratio monitoring or things of that sort. This was decided so that
  50. PCBURM would be SIMPLE AND EASY for any sysop to get up and running in a
  51. matter of minutes.
  52.  
  53. Features of PCBURM:
  54.  
  55.         o Support for baud rates up to 115,200 bps
  56.         o Support for non-standard COM IRQ's
  57.         o Complete monitoring of COM ports for carrier loss
  58.         o Option to display comment to user
  59.         o Option to exclude security levels
  60.         o Option to print log information to CALLERx file
  61.         o Full Multi-Node support
  62.         o Sysop function keys are supported
  63.         o Most of all - SIMPLE to use
  64.        o Supports Fossil driver (for PCBoard /M version)
  65.  
  66.  
  67.  
  68.                       PROGRAM INSTALLATION/OPERATION
  69.                       ==============================
  70.  
  71.  
  72. Step #1: - Create configuration file
  73. ========
  74.  
  75. Edit PCBURM configuration file, PCBURM.CFG using the program URMCFG.EXE
  76. included with PCBURM. You may also manually edit PCBURM.CFG using your
  77. favorite text editor.
  78.  
  79. The items in the configuration file are as follows, do not include the line
  80. number references. Refer to detailed explanation below for each line:
  81.  
  82.         PCBURM.CFG
  83.         ------------------------------------------
  84. Line 1: C:\PCB\USERS.SYS
  85. Line 2: Corp Headquarters
  86. Line 3: Bob
  87. Line 4: Neal
  88. Line 5: 0
  89. Line 6: PCBURM.LOG
  90. Line 7: 1
  91. Line 8: 50000
  92. Line 9: /10/25/50          (or the word NONE)
  93. Line10: STRICT             (or the word NOSTRICT)
  94. |Line11: NO                (or the word YES)
  95.  
  96. Line 1: Enter full path/filename of your USERS.SYS file. PCBURM supports the
  97.         PCB environment variables, %PCBDRIVE% and %PCBDIR%. Those running a
  98.         multi-node system may wish to replace this line with the following:
  99.  
  100.                 %PCBDRIVE%%PCBDIR%\USERS.SYS
  101.  
  102.         PCBURM will read the current PCBoard drive and directory from these
  103.         variables.
  104.  
  105. Line 2: BBS Name
  106.  
  107. Line 3: Sysop's first name
  108.  
  109. Line 4: Sysop's last name
  110.  
  111. Line 5: Registration number, leave as 0 if not registered. You will be
  112.         be provided with a registration number to enter here when you
  113.         send you payment.
  114.  
  115. Line 6: If you place the word CALLER on this line, PCBURM will write it's log
  116.         information PCBoard's CALLERx file. I find this handy as I can
  117.         see each users status each time I scan my CALLERx file.
  118.  
  119.         You can also have PCBURM maintain it's own log file by placing the
  120.         full path/filename to be written to on this line. The log file created
  121.         will include the name of the user, node used, security level assigned
  122.         to the user as well as the date and a brief text line explaining what
  123.         ratio enforcements were placed on the user. If a user exceeded his
  124.         requirements, the log file will include the current ratios of the user
  125.         at the time the program monitored his activity.
  126.  
  127. Line 7: Free FILE credits to be given. You may use this line to give "free"
  128.         credits to new users. If you would like to grant some "free" credits
  129.         to a user, place the value here. In the above example, a new user
  130.         would be given credit for one upload. If a user was given a 5:1 file
  131.         ratio requirement, he could then download 5 files before needing to
  132.         upload anything. After downloading 5 files PCBURM would restrict
  133.         download ability until a file was uploaded.
  134.  
  135. Line 8: Free BYTE credits to be given. Same explanation for the file credit.
  136.         Using the above example, a new user could download 250,000 bytes if a
  137.         5:1 ratio was in place before he would need to upload anything. This
  138.         option allows new users access to your file area without requiring an
  139.         initial upload.
  140.  
  141.         Please note that the values used on line 7 and 8 are used internally
  142.         to the program. It will not actually add this information to the users
  143.         file, therefore keeping your user file statistics accurate (unlike
  144.         some other similar type of programs).
  145.  
  146. Line 9: You can optionally exclude specific security levels from ratio check
  147.         by placing the levels desired on this line. Seperate each level with
  148.         the "/" character, see example above. Place the word NONE on this line
  149.         if you do not wish to exclude any security levels from ratio check.
  150.  
  151. Line10: You can select if you want PCBURM to enforce a STRICT byte ratio
  152.         requirement or not. Placing the word STRICT on this line would
  153.         cause PCBURM to calculate the remaining number of bytes the user
  154.         could download. PCBURM will use this calculated figure if it is
  155.         less than the number of bytes granted a user in the PWRD file.
  156.         Put the word NOSTRICT on this line if you do not want this
  157.         feature, instead PCBURM will grant a daily download bytes equal
  158.         to what you have indicated in the PWRD file.
  159.  
  160. |Line11: PCBURM can be set for discrete statistics display. Placing YES
  161. |        on this line will display the full user statistics only if the
  162. |        user is outside of the ratio limits you have prescribed. If the
  163. |        user is within ratio limits, a single line display is shown.
  164. |        Placing NO on this line will inform PCBURM to display the file
  165. |        statistics display at each call.
  166.  
  167.  
  168.  
  169.  
  170.  
  171. Step #2: - Create file ratio requirements file
  172. ========
  173.  
  174. Edit the requirement file, PCBURM.REQ. Use your favorite text editor to
  175. edit this file: The format is as follows:
  176.  
  177. SECURITY LEVEL, FILE RATIO, BYTE RATIO, USER COMMENT
  178.  
  179. For example:
  180.  
  181. 30,5,10,Regular User
  182. 40,10,20,Supporting User - Thanks for your payment
  183. 200,0,0,Sysop
  184. 999,1,1,Unknown Access Level - Please inform sysop
  185.  
  186. In the above example, the first line is for a security level 30 user. He has a
  187. 5:1 file ratio requirement, a 10:1 byte ratio requirement. The USER COMMENT
  188. field ("Regular User") will be displayed as part of the user statistics
  189. displayed by the program. You can use this field to put any information you
  190. desire, maybe enter information about subscription that your board may offer.
  191.  
  192. In the second example, this is for a security level 40 user. He has a 10:1
  193. file ratio requirement and a 20:1 byte ratio requirement.
  194.  
  195. In the third example, this is a security level 200 user. The file and byte
  196. ratios have been set to "0", this informs PCBURM that this user is exempt for
  197. maintaining any ratio requirements (might be used for subscribing user,
  198. co-sysops and sysops). You may set the byte and/or file ratio to zero if you
  199. do not with to enforce a ratio requirement.
  200.  
  201. The last example is recommended as the last line for every PCBURM.REQ file.
  202. This is used as the DEFAULT security ratio. If a security level is not found
  203. in the line preceeding this last line, these ratios will be assigned to the
  204. user. Using the above example, if the user had a security level of 60, PCBURM
  205. would use the file requirements as shown on this line as a level 60 was not
  206. previously assigned a ratio requirement.
  207.  
  208.  
  209.  
  210. Step #3 - Setup PCBURM as a door
  211. =======
  212.  
  213. Setup PCBURM as a PCBoard Door.  Run PCBSetup, edit the door security file and
  214. add the following line:
  215.  
  216.                                   USER DOOR
  217.  Filename    Password   Sec Login SYS  SYS  Shell Path to DOOR Files
  218. ══════════ ════════════ ═══ ═════ ════ ════ ═════ ═══════════════════     
  219. PCBURM                   0    Y    Y    N     Y
  220.  
  221. The "Login" and "Shell" are both optional. If you have enough memory, it is
  222. recommended that you use the "shell" option of PCBoard. The USERS.SYS field
  223. must be set to Y or PCBURM will not work!
  224.  
  225.  
  226. Step #4 - Create script file
  227. =======
  228.  
  229. Edit the PCBURM door script, again using your favorite text editor. Below is
  230. an example of a suggested script (example presumes PCBURM is located on drive
  231. "C" and in directory "PCBURM"):
  232.  
  233.      @ECHO OFF
  234.      C:
  235.      CD \PCBURM
  236.      PCBURM PCBURM.CFG
  237.      %PCBDRIVE%
  238.      CD %PCBDIR%
  239.      IF (%INPCB%)==(Y) EXIT
  240.      BOARD
  241.  
  242. The line "IF (%INPCB%)==(Y) EXIT" is used to exit from shelled doors. If you
  243. won't run PCBURM as a shelled door, it may be removed.
  244.  
  245. PCBURM supports COM1-4, using standard IRQ's. If you wish to use a
  246. non-standard IRQ, add the IRQ number after the configuration file name. For
  247. example "PCBURM PCBURM.CFG /5" (tells PCBURM to use IRQ 5 instead of standard
  248. IRQ value). No parameter is required if using standard IRQ values.
  249.  
  250. |Some users may have had conflicts when using non-standard IRQ's on
  251. |Novell/Netware systems. Novell seems to use the "/" character for
  252. |parameter passing. You may not optionally use the "*" character instead
  253. |of the "/".
  254.  
  255.  
  256. That's all there is to do. PCBURM will adjust the daily download bytes allowed
  257. as indicated in the PWRD file to monitor and enforce the file/byte ratio's. If
  258. you have used another file ratio enforcement program, check to see that you
  259. have re-entered this information in the PWRD file (some ratio enforcers have
  260. required you to zero out this information. Not PCBURM, PCBURM reads this
  261. information.
  262.  
  263. When PCBURM is run, it will display the users file/byte statistics. It will
  264. also display if the user is within your established ratio requirements, or if
  265. not, will inform him accordingly. In addition, PCBURM will maintain a log file
  266. (PCBURM.LOG) which will indicate what actions were taken by the program, or if
  267. the user was within ratio requirements. You may wish to delete this file
  268. regularly as necessary.
  269.  
  270.  
  271. FOSSIL DRIVER
  272. =============
  273.  
  274. PCBURM now includes support for FOSSIL drivers. This means that the
  275. program will now work with Digiboard (for PCBoard/M versions) and other
  276. multi-port boards. To activate the Fossil driver support just include
  277. /FD on the command line in your door batch file.
  278.         For example: PCBURM PCBURM.CFG /FD
  279.  
  280. If no Fossil driver is available, PCBURM will display a message
  281. indicating such and exit cleanly.
  282.  
  283.  
  284.  
  285.  
  286.  
  287.                               REGISTRATION
  288.                               ============
  289.  
  290. PCBURM is released as user support software (aka SHAREWARE). I don't expect
  291. you to register the program if you don't like it or if it doesn't meet your
  292. needs (just stop using it). But if you continue to use PCBURM after a
  293. reasonable evaluation period of up to 30 days, you are required to make
  294. payment for the program or stop using it.
  295.  
  296. PCBURM is NOT crippled in any way other than for a momentary reminder at the
  297. termination of the program that the program is not registered. Once you
  298. register the program, you will be provided with a registration number which
  299. will remove this reminder notice.
  300.  
  301. Registration is only $15 and will include unlimited free upgrades and support
  302. via my BBS.
  303.  
  304. Please use the form REGISTER.FRM included with the program to register PCBURM.
  305. If this file is missing, send a check for $15 (US funds) to:
  306.  
  307.         Robert Neal
  308.         317 Hickory
  309.         Romeoville, IL  60441
  310.  
  311. |You may also register online with Visa/MC/AMEX and Discover by calling
  312. |the support BBS (815) 886-3233 or (815) 886-9381. At the main menu type
  313. |CHARGE, then follow prompts from there.
  314.  
  315. Please include your BBS name as this information will be used to create your
  316. unique registration key file. You may receive your registration file via my
  317. support BBS (but please be sure you have an account established on my BBS so
  318. that I can leave this information in a private message to you) or via the US
  319. Mail. Please indicate your preference.
  320.  
  321. Keep your eye open for other utility programs from me written for PCBoard.
  322. Several programs are now in the works and should be released soon. Also, look
  323. for my door programs, Card Sharks and Links Golf (available on my BBS as
  324. well), I think your users will enjoy playing them.
  325.  
  326.  
  327.                               TROUBLESHOOTING
  328.                            =====================
  329.  
  330. If you are running this on a 486 system with co-processor, you may need
  331. to put 'SET NO87=ON' in your AUTOEXEC.BAT file or you may place this in
  332. the PCBURM batch file just before the line PCBURM PCBURM.CFG, for
  333. example:
  334.  
  335.      @ECHO OFF
  336.      C:
  337.      CD \PCBURM
  338.      SET NO87=ON
  339.      PCBURM PCBURM.CFG
  340.      %PCBDRIVE%
  341.      CD %PCBDIR%
  342.      IF (%INPCB%)==(Y) EXIT
  343.      BOARD
  344.  
  345.  
  346. If you are running on a 486 system with co-processor under DesqView, you
  347. may alternately set Math Coprocessor in each window to YES.
  348.  
  349.  
  350.  
  351.  
  352.                                   SUPPORT
  353.                             ===================
  354.  
  355. If you have any questions, comments, problems, suggestions for enhancements,
  356. etc., I may be reached at my support BBS or by mail. In addition, you may send
  357. a message to me on the RIME conferences to my BBS "CHQBBS", I regularly
  358. monitor the messages in the Sysop, BBS and PCBoard Support conferences. I can
  359. also be reached via Prodigy, PNSP01A.
  360.  
  361.  
  362.  
  363.                              LEGAL INFORMATION
  364.                       ===============================
  365.  
  366. This program is provided on an "AS IS" basis.  No warranty of any kind is
  367. expressed or implied.  YOU USE THIS PROGRAM AT YOUR OWN RISK.  I take no
  368. responsibility for any damage caused directly or indirectly from the use or
  369. the inability to use this program.
  370.